widget: Notify a11y of focus changes

This is using the new 'platform changes' mechanism
to tell the a11y backends when focus changes.

a11y: Pass on platform changes

Add an enum for 'platform changes' to the at context
change notification mechanism. This will let us pass
along things that ARIA considers 'platform state' such
as focus or editability. The difference between the
platform state and other ARIA states is that we don't
keep the platform state separately in the at context
- backends are expected to just query the widgets.

This is just about avoiding notify listeners for
change notification.

atspi: Be more careful about indexes

Don't return a number for IndexInParent when we
don't have one.

atspi: Set some more atspi states

Pass on more of the states that are represented
as properties in aria: modal, multi-line, orientation.

Pass orientation property to accessible

We should set the accessible properties we have,
where they make sense. So set orientation, if the
widget is orientable.

wip: Emit StateChanged signals

This is not fully baked, but it is enough to make accerciser
notice when a text entry goes from editable to not editable.

atspi: Derive readonly state from aria properties

We can use the read-only property, together with the
accessible role, to determine whether to set editable
and read-only states for at-spi. This lets us avoid
directly poking at the widgets.

text: Set the readonly accessible property

This mirrors what we already do for GtkTextView.

atspi: Set editable state

ATs look at not just the implemented interfaces, but
also the states to decide what to do. It turns out that
the EditableText interface is only used by accerciser
if the editable state is set. So set it.

atspi: Implement EditableText interface

Implement EditableText for GtkText and GtkTextView.

atspi: Break out the Value implementation

This isn't necessarily very big, but it keeps
the widget checks out of gtkatspicontext.c, and
it is a nice pattern.

atspi: Break out the Text implementations

Move the implementation of the Text interface
to its own source file, and split it up along
widget lines, to avoid it becoming too messy.

scalebutton: Set accessible value properties

This is what we did in GTK 3.

paned: Set accessible value properties

This is what we did in GTK 3.

Simplify GetInterfaces handling

It is error prone to keep the same conditions in sync
in two places. Instead, just assemble the list of interfaces
as we register objects, and use when GetInterfaces is called.

atspi: Implement Value for more widgets

Apply the Value implementation to the widgets where
we had one in GTK 3: GtkLevelBar, GtkRange, GtkScaleButton,
GtkSpinButton, GtkPaned, GtkProgressBar. To make these
work, the widgets need to set the accessible value properties.

atspi: Implement Value interface for ranges

atspi: Implement Text interface for text views

With this, all relevant widgets support the
Text interface.

atspi: Add textview utilities

These are very similar to the pango utilities,
and are copying code from the textview accessible
implementation in GTK 3.

atspi: Export more pango utils

We are going to reuse some of the code that does
the pango -> atspi attribute conversion for text
tags.

atspi: Implement text for GtkText widgets too

There is some open question here whether the interface
should be implemented on the outer or the inner widget
of the entry-text pairs. For now, our hand is forced,
since only GtkText provides access to the layout that
we need for implementing many of the interface methods.

atspi: Implement Text interface for labels

This is a not-quite-complete implementation of the
Text interface for GtkLabel. The missing parts are
anything around extents and positions, as well as
the ScrollSubstring apis.

atspi: Add pango utilities

This code is more or less a direct copy of what
we had in gtkpango.c in 3.x.

atspicontext: Fix GetIndexInParent for toplevels

For toplevels, we need to return the index in the
list of toplevels, since that is what GtkAtspiRoot
is using.

atcontext: labelled-by has a reference list

This is unclear - our docs state that all the
relations have value type reference, but in fact
they all have value type reference list.

atspicontext: Implement GetRelationSet

This translates relations as far as the match.

I'm not sure yet what we can do about the fact that
atspi expects relations to be bidirectional (ie have
label-for *and* labelled-by) while aria has only one
direction.

atspiroot: Stub out GetRelationSet

This needs to be fully implemented, for now sending
an empty relation set back prevents accerciser from
getting hung up.

atspi: Add the AtspiRelationType enum

This is what we need to map the aria relation
types to.

Move atspi enums to gtkatspiprivate.h

Add a GetInterfaces method

It turns out that accerciser depends on this undocumented
method that is not in the xml at all, otherwise interface
sections in the accerciser ui never get enabled.

Don't pass NULL to g_variant_new_string

That does not work.

atspi utils: Fix an oversight

gtk_accessible_role_to_atspi_role must always return
an atspi role. The fallback was returning an aria
role.

Fixup: Add a forgotten #pragma once

a11y: Convenience API for referencing ATSPI root node

We turn the root node into a reference fairly often, so it's worth it to
have a utility function that does this for us.

a11y: Add utility function for null refs

ATSPI was written for CORBA, which allows passing around "nil"
as valid object references.

atspicontext: Implement GetState

Translate the aria states to at-spi's interpretation
of atk states.

atspiroot: Fix GetState implementation

When the GetState signature says 'au', it actually
means a bitset that is sent as a pair of 32bit integers.

atspiroot: Implement GetIndexInParent

Just for good measure

atspicontext: Implement GetIndexInParent

This is needed for ATs to take our tree seriously.

atspicontext: Implement more accessible api

Implement GetChildAtIndex, GetChildren and ChildCount.

atspiroot: Implement GetChildren

No surprises here.

atspiroot: Don't leak references

The reffing getter trap, lurking behind g_list_model_get_item().

atspiroot: Implement GetLocale

atspicontext: Print out the a11y bus address

Make our debug spew useful: Having the bus address
makes it easy to jump on the a11y bus to look around
with dbus tools.

a11y: Localise the role name of the root node

a11y: Register the Accessible interface on all AtSpiContext instances

This is not a complement implementation.

a11y: Implement more ATSPI methods on the root node

a11y: Add method to extract desktop data

We are going to need the desktop name and path to populate the parent
property of AtSpiContexts associated to top level widgets.

a11y: Validate the DBus context path

UUIDs use dashes to separate the various blocks; unfortunately, this
results in an invalid DBus object path. Replace the dashes with an
underscore.

a11y: Turn accessible roles to string

Add a simple utility function to turn GtkAccessibleRole values into the
appropriate string, including localization.

a11y: Convert GTK roles to ATSPI ones

There's not a precise, 1:1 mapping between the newer ARIA roles and the
older ATSPI ones. We make do with what we have.

a11y: Compute the label for a GtkATContext

The ARIA spec defines the mechanism for determining the name of an
accessible element—see §4.3 of the WAI-ARIA spec.

We follow the specification as much as it makes sense for GTK to do
so:

 1. if the element is hidden, return an empty string
 1. if the element has a labelled-by relation set, retrieve the
    label of the related element
 2. if the element has a label property set, use the value of
    the property
 3. if neither labelled-by nor label attributes are set, we use
    the role to compute the name:
   - for a `range` role, we return the contents of the value of
     the `value-text` or `value-now` properties
   - for any other role, we return a textual representation of
     the GtkAccessibleRole enumeration value

tests: Use the test ATContext for every test

Otherwise we're going to need a full desktop session in order to run the
test suite.

a11y: Return the ATSPI role for the root element

a11y: Add AT-SPI cache object

Right now, the cache is unused, and we still need to implement the
serialisation method and emit the signals.

a11y: Ignore widgets during destruction

There's no point in creating a GtkATContext when a widget is getting
destroyed.

a11y: Register the accessible root object

When we create the first AT-SPI context we also need to register the
accessible root on the accessibility bus. The accessible root object is
the main entry point of an accessible application, and it holds the
global state to present to the ATs that connect to the bus.

a11y: Add a display to GtkATContext

Since we need to check at run time what kind of AT context to use, we
need a hook into the whole GDK backend machinery. The display connection
seems to be the best choice, in this case, as it allows us to determine
whether we're running on an X11 or Wayland system, and thus whether we
should create a GtkAtSpiContext.

This requires some surgery to fix the GtkATContext creation function, in
order to include a GdkDisplay instance.

a11y: Add dummy AT-SPI context

Does not do anything, at the moment, but it's going to get filled out
soon.

The backend is selected depending on the platform being compiled in;
since we're using AT-SPI on X11 and Wayland, and we don't have other
accessibility implementations, we currently don't care about run time
selection, but we're going to have to deal with that.

a11y: Add the AT-SPI DBus descriptions

And generate the code for the DBus interfaces.

We don't want the full object manager experience, here, because we're
going to have a single object responding to various interfaces and
remote method calls. For this reason, we're not using the gnome module
in Meson to call gdbus-codegen for us: we need to use the interface info
command line arguments, and those are not available from Meson.

Use test AT context with installed tests

Otherwise we're going to need an AT-SPI service on the session, and the
accessibility bus.

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2683

Generate introspection for GdkWayland API

Like we do for GdkX11. We can't use all of the public C API, but we can
expose enough type information to allow non-C developers to actually
check if they are running the Wayland GDK backend or not—plus some
additional Wayland-specific API.

Add type annotations for GdkWayland API

The GdkWayland API takes generic GDK types and performs a run time
check, which means we need to properly annotate the actual expected
type in order to have methods recognised as such.

Skip GdkWayland symbols that use wayland-client types

The wayland-client API does not have introspection annotations, so we
can't use these types anyway.

Updated Lithuanian translation

Merge branch 'wip/chergert/gdk-macos-fixes' into 'master'

various build fixes for GDK/GTK on macos

See merge request GNOME/gtk!2680

Update Polish translation

Updated Czech translation

macos: port gtk to GDK_WINDOWING_MACOS

For the various uses of GDK_WINDOWING_QUARTZ, we need to use
alternatives from GDK_WINDOWING_MACOS.

Some minor loss of functionality is here, such as icons sent with
application menus. That can certainly be added back at a future
point.

gtk: use GDK_WINDOWING_MACOS in gentypefuncs.py

gdk: remove quartz subdirectory from backends

macos: add key equivalent helper

This is needed by quartz code in gtk/.

macos: remove workaround for scroll delta

This gets handled differently in gtk/ and so we shouldn't translate it here.

macos: track various changes in GDK

macos: lookup NSEvent by translated GdkEvent

This will be needed by the quartz imcontext.

macos: move input method names to private header

demo: fix out of bounds array index usage

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #3242 and #3240

See merge request GNOME/gtk!2679

gtk-demo: Keep undisplayable resources out of view

No point in showing an apologetic tab for a blob of binary data.
gtk4-demo shows the resources under /DEMONAME/ for each demo,
so move the data to /DEMONAME_data/.

Merge branch 'ebassi/for-master' into 'master'

Tone down a user visible message

See merge request GNOME/gtk!2678

Send focus events to the root

We are not propagating focus change events, and that is the only
place where we are listening for focus change events. If GtkWindow
does not see focus-in events for its popovers, we end up with
inadvertendly inactive windows.

Fixes: #3240

window: Be more careful when looking for focus

When passing focus up to a parent, make sure the
newly chosen focus widget actually accepts the focus.

build: Require sysprof 3.38.0

We use sysprof_collector_request_counters, which
was introduced in sysprof 3.38.0.

gtk-demo: Ellipsize columns in the characters demo

some of the columns have uneven widths, causing them
to bounce around as you scroll. Ellipsize them and
give them a fixed with.

docs: Add more details to the migration guide

Add some details about GdkSurface and GtkWindow api changes.

Fixes: #3242

Tone down a user visible message

Self-deprecating humour badly translates to a demo message.

Merge branch 'kjellahl/gdkseat' into 'master'

gdkseat: Make gdk_seat_get_tools() public

Closes #3241

See merge request GNOME/gtk!2677

gdkseat: Make gdk_seat_get_tools() public

Fixes #3241

Merge branch 'fix.builder.msvc' into 'master'

testsuite/gtk/builder.c: Fix running on Visual Studio

See merge request GNOME/gtk!2676

testsuite/gtk/builder.c: Fix running on Visual Studio

Explicitly say in the code that we are exporting the symbols so that when the
test program runs, it can find the required builder symbols.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2674

gdk: Drop gdk_surface_new_temp

It is not used anymore.

win32: Stop using gdk_surface_new_temp

No need to roundtrip through the frontend to create
one of our own surfaces.

broadway: Stop using gdk_surface_new_temp

No need to roundtrip through the frontend to create
one of our own surfaces.

x11: Stop using gdk_surface_new_temp

No need to roundtrip through the frontend to create
one of our own surfaces.

wayland: Stop using gdk_surface_new_temp

No need to roundtrip through the frontend to create
one of our own surfaces.

gdk: Drop some unused private api

No users of gdk_display_peek_event, gdk_display_has_pending
_gdk_display_event_data_copy or _gdk_display_event_data_free,
so drop all of these, and related vfuncs.

Merge branch 'master' into 'master'

Allow LPR backend to print PDF and PS file formats

See merge request GNOME/gtk!418

Merge branch 'wip/otte/for-master' into 'master'

textbuffer: Don't serialize the \0 byte

See merge request GNOME/gtk!2672